home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / bdrag10.zip / SYSOP.DOC < prev    next >
Text File  |  1996-05-17  |  53KB  |  1,534 lines
  1.                                                                       
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10. ┌───────────────────────────────────────┐
  11. │                                       │
  12. │   ·                      ∙         ·  │
  13. │    .           .         :     .      │
  14. │                     ·    :            │
  15. │           .              |            │
  16. │                          │            │
  17. │             ··  ─   ── ──┼── ──  ─  ··│
  18. │   .                      │            │
  19. │                          |            │
  20. │                 .        :      .     │
  21. │           ·              ∙            │
  22. │  ·    .                            ·  │
  23. │                     ·                 │
  24. │          ·     .                      │
  25. │                      /\       .    ·  │                                  
  26. │   .                /^  ^\             │      A Guide to Concerto Scripts   
  27. │           █▄█▄█▄█/^\     ^\      /\   │                  Revision 960517
  28. │            ▄ ▄ ▄    ^\     ^\  /^  ^\ │       Copyright 1995-1996 Altair
  29. │           /▄▄ ▄▄             /^       │
  30. │         /^ ▄ ▄ ▄  \        /^         │
  31. │ ^\    /^   ▄▄ ▄▄   ^\    /^     /\    │
  32. │   ^\/^     ▄ ▄ ▄       /^     /^  ^\  │
  33. │     ^\     ▄▄ ▄▄            /^      ^ │
  34. │            ▄ ▄ ▄  \       /^          │
  35. │       /^\  ▄▄ ▄▄   ^\   /^            │
  36. │     /^   ^\  ▄ ▄                      │
  37. │   /^       ^\  ▄   /\          /\     │
  38. │ /^           ^\  /^  ^\      /^  ^\   │
  39. │                 ^      ^\          ^\ │
  40. │           /\                          │
  41. │         /^  ^\       /\               │
  42. │       /^       \   /^  ^\             │
  43. │     /^           /^                   │
  44. │                /^                     │
  45. │                                       │
  46. │                                       │
  47. │                                       │
  48. └───────────────────────────────────────┘
  49.                        
  50.   
  51.  
  52.  
  53.   Using This Manual
  54.  
  55.     
  56.  
  57.     Generalizations
  58.  
  59.     This document is a reference guide to features found in many products
  60.     designed with the Concerto Door Development Kit.  At this time please
  61.     refer to the alternate documentation supplied with your software.
  62.  
  63.  
  64.  
  65.     Technicality
  66.  
  67.     We assume that you are familiar with MS-DOS paths, enviroment 
  68.     variables and command-line parameters.  You may wish to review
  69.     these concepts before using this manual.
  70.  
  71.  
  72.  
  73.     Icons
  74.  
  75.       o~    The Wizard      This icon is next to sections containing somewhat
  76.     */\\>                   technical information of interest to experienced
  77.       < \                   sysops.
  78.  
  79.  
  80.       ,  ,
  81.       \o/   The Neophyte    This icon appears next to sections intended                               
  82.       //                    for novices.
  83.      <<      
  84.                                                            
  85.  
  86.       ()    The Spectre     Always heed the warnings of the Spectre. 
  87.      /\/\                   
  88.     ` || ;    
  89.       |'   
  90.       '    
  91.       '    
  92.  
  93.  
  94.     Altair: Behold the Future (tm)
  95.  
  96.     This document is copyrighted (c) 1995-1996 Altair.  All rights are
  97.     reserved worldwide.  Send your comments to Altair, P.O. Box 175,
  98.     Stillwater, MN 55082-0175.  Copyright and trademark acknowledments
  99.     appear near the end of this document.
  100.  
  101.                                       
  102.   r e q u i r e m e n t s
  103.   ──────────────────────────────────────────────────────────────────────────
  104.  
  105.  
  106.   80x86 IBM PC                 This software will run on any IBM-compatible 
  107.                                computer using an Intel 80x86 CPU.  Some
  108.                                features, however, are disabled if a 286 or
  109.                                higher is not detected.  Some mathematical
  110.                                operations will utilize the 386/486 CPU, if
  111.                                detected.
  112.  
  113.  
  114.   256K Conventional Memory     A typical session requires at least 256K RAM.
  115.                                Some programs may use EMS and XMS memory
  116.                                if detected.
  117.  
  118.  
  119.   MS-DOS 3.3 or Equivalent     The software will automatically detect and
  120.                                release time slices to DesqView, Windows/286,
  121.                                Windows 3.x, Windows NT, Windows 95 and OS/2.
  122.  
  123.  
  124.   FOSSIL Driver                A FOSSIL driver allows the program to access
  125.                                your communications hardware in a device-
  126.                                independent manner.  You must install a
  127.                                FOSSIL driver specific to your hardware or
  128.                                operating system.  Drivers are available for
  129.                                DOS, Windows 95 and OS/2.
  130.  
  131.  
  132.   SHARE.EXE                    A file-sharing driver is required if you are
  133.                                using a multi-tasking or networked enviroment.
  134.                                SHARE.EXE manages conflicts when two or more
  135.                                instances of the program try to access the
  136.                                same file.  Type HELP SHARE at your MS-DOS
  137.                                prompt for more information.
  138.  
  139.  
  140.   EGA/VGA Video Card           Several aesthetic effects are enabled if
  141.                                an EGA or VGA graphics card is detected.
  142.                                Most of these effects are purely for the
  143.                                enjoyment of the sysop and do not affect the
  144.                                functionality of the software. 
  145.  
  146.   o v e r v i e w 
  147.   ──────────────────────────────────────────────────────────────────────────
  148.  
  149.   o  Scripts are totally free-form.  You may use any style of
  150.      indentation and capitalization.  More than one command may
  151.      exist on a single line, and parameters can extend across
  152.      multiple lines.
  153.  
  154.   o  A semicolon forces the software to ignore the rest of the
  155.      text on the current line.  This is a good way of placing
  156.      comments in a script.
  157.  
  158.   o  Assigning a value to a variable is easy:
  159.  
  160.      Let VARIABLE = VALUE
  161.       │   │       │  └────── The value to store in the variable
  162.       │   │       └───────── Optional assignment operator
  163.       │   └───────────────── The name of the variable
  164.       └───────────────────── Optional keyword
  165.  
  166.  
  167.  
  168.   BOOLEAN VARIABLES (aka TRUE/FALSE)
  169.  
  170.     ┌───────────────┐
  171.     │  True   False │  Examples:
  172.     ├───────┬───────┤
  173.     │   +   │   -   │    Variable = +
  174.     │   1   │   0   │    Variable = 0
  175.     │   T   │   F   │    Variable = True
  176.     │   Y   │   N   │    Variable = No
  177.     └───────┴───────┘
  178.      
  179.  
  180.   CHARACTER VALUES
  181.  
  182.     There are several ways specifying a single character:
  183.  
  184.       a. Normal           Variable = a
  185.       b. Literal          Variable = " "
  186.       c. Decimal          Variable = #99
  187.       d. Hexadecimal      Variable = $FF
  188.       e. Control          Variable = ^C                      
  189.  
  190.  
  191.   NUMERIC VALUES
  192.  
  193.       a. Decimal          Variable = 255
  194.       b. Hexadecimal      Variable = $FF
  195.  
  196.  
  197.   STRING VARIABLES
  198.  
  199.     You must enclose the string in double quotation marks (").  
  200.     
  201.   m a c r o s  
  202.   ──────────────────────────────────────────────────────────────────────────
  203.  
  204.   Variables can be imbedded in any text file or string.  Such a variable
  205.   is called a macro.  The simplest type of macro looks like this:
  206.  
  207.  
  208.          {Variable}
  209.          │  │     │
  210.          │  │     └─ Right delimiter
  211.          │  └─────── The name of a variable
  212.          └────────── Left delimiter
  213.  
  214.  
  215.   The software automatically replaces the macro with the value of the
  216.   variable.  In some cases it may be desirable to format the result
  217.   to a certain length of characters (i.e. to align columns).  This is
  218.   done by using the optional size parameter:
  219.  
  220.  
  221.          {Variable:Size}
  222.                   │  │
  223.                   │  └─ The size of the result.
  224.                   └──── Colon
  225.  
  226.  
  227.   The value of the variable will be clipped or padded to ensure the
  228.   desired length.  By default the result is left-justified.  You
  229.   can right-justify the string by using a negative sign: